package com.waitingsnow.common.share.netEaseMicroblog.blocks
{
	import com.waitingsnow.common.share.bridia.net.oauth.BDOAuthConnection;
	import com.waitingsnow.common.share.netEaseMicroblog.NEMicroblog;
	import com.waitingsnow.common.share.netEaseMicroblog.data.NEMObject;
	
	/**
	 *  
	 * @author Tensharp
	 * 
	 * <p>访问所有的黑名单接口.</p>
	 * 
	 */	
	
	public class NEMBlocks extends NEMObject
	{
		/**
		 * 
		 * <p>创建一个新的NEMBlocks接口.</p> 
		 * 
		 * @param parent 上级对象.(NEMicroblog)
		 * @param oauth OAuth链接
		 * 
		 */		
		
		public function NEMBlocks(parent:NEMicroblog, oauth:BDOAuthConnection)
		{
			super(parent, oauth);
		}
		
		///
		///	[Blocks create]
		///
		
		/**
		 * 
		 * <p>blocks/create</p>
		 * <p>阻止指定用户，即将该用户添加进黑名单。</p> 
		 * 
		 * <ul>
		 * 	<li>如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200；</li>
		 * 	<li>如果不是则返回401的状态和错误信息；</li>
		 * 	<li>根据参数查找不到对应的用户则返回404的状态和错误信息。</li>
		 * </ul>
		 * 
		 * @param user_id 		可选参数 : 用户ID，主要是用来区分用户ID跟微博昵称相同产生歧义的情况。
		 * @param screen_name 	可选参数 : 该用户的个性网址，也可以传user_id；
		 * 
		 */	
		
		public function blocks_create (user_id:String = null, screen_name:String = null):void
		{
			oauth.addOAuthParameters ("user_id", user_id);
			oauth.addOAuthParameters ("screen_name", screen_name);

			//
			
			super.connect ("BLOCKS_CREATE", "POST");
		}
		
		///
		///	[Blocks destroy]
		///
		
		/**
		 * 
		 * <p>blocks/destroy</p>
		 * <p>取消已阻止的用户，即将该用户添移除黑名单。</p> 
		 * 
		 * <ul>
		 * 	<li>如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200；</li>
		 * 	<li>如果不是则返回401的状态和错误信息；</li>
		 * 	<li>根据参数查找不到对应的用户则返回404的状态和错误信息。</li>
		 * </ul>
		 * 
		 * @param user_id 		可选参数 : 用户ID，主要是用来区分用户ID跟微博昵称相同产生歧义的情况。
		 * @param screen_name 	可选参数 : 该用户的个性网址，也可以传user_id；
		 * 
		 */
		
		public function blocks_destroy (user_id:String = null, screen_name:String = null):void
		{
			oauth.addOAuthParameters ("user_id", user_id);
			oauth.addOAuthParameters ("screen_name", screen_name);
			
			//
			
			super.connect ("BLOCKS_DESTROY", "POST");
		}
		
		///
		///	[Blocks exists]
		///
		
		/**
		 * 
		 * <p>blocks/exists</p>
		 * <p>判断是否已经阻止用户,如已阻止此用户则返回用户信息，如未阻止则返回状态404，同时提示“此用户未被加入黑名单”。</p> 
		 * 
		 * <ul>
		 * 	<li>如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200；</li>
		 * 	<li>如果不是则返回401的状态和错误信息；</li>
		 * 	<li>根据参数查找不到对应的用户则返回404的状态和错误信息。</li>
		 * </ul>
		 * 
		 * @param user_id 		可选参数 : 用户ID，主要是用来区分用户ID跟微博昵称相同产生歧义的情况。
		 * @param screen_name 	可选参数 : 该用户的个性网址，也可以传user_id；
		 * 
		 */	
		
		public function blocks_exists (user_id:String = null, screen_name:String = null):void
		{
			oauth.addOAuthParameters ("user_id", user_id);
			oauth.addOAuthParameters ("screen_name", screen_name);
			
			//
			
			super.connect ("BLOCKS_EXISTS");
		}
		
		///
		///	[Blocks blocking]
		///
		
		/**
		 * 
		 * <P>返回当前登录用户屏蔽的用户列表。</P>
		 * <P>如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200；</P>
		 * 
		 */	
		
		public function blocks_blocking ():void
		{
			super.connect ("BLOCKS_BLOCKING");
		}
		
		///
		///	[Blocks blocking ids]
		///
		
		/**
		 * 
		 * <p>返回当前登录用户屏蔽的用户id数组。</p> 
		 * <p>如果用户通行证身份验证成功且用户已经开通微博则返回http状态为200；</p>
		 * 
		 */	
		
		public function blocks_blocking_ids ():void
		{
			super.connect ("BLOCKS_BLOCKING_IDS");
		}
	}
}